home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / slrenam2.arc / SLRENAME.DOC < prev    next >
Text File  |  1991-01-21  |  4KB  |  100 lines
  1.         SLRENAME 1.1 - Turn handles into real names for SL export
  2.           -----------------------------------------------------
  3.  
  4. This program was written with Searchlight BBS systems running SLMAIL to
  5. export echomail messages to *.MSG format in mind.
  6.  
  7. Version 1.1 corrects a very minor bug (deals with error trapping) and
  8. corrects an error in the documentation. SLRENAME does not read the
  9. configuration filename from the command line. It expects to find SLRENAME.CFG
  10. in the default path.
  11.  
  12.  
  13. Overview:
  14.  
  15. This program is an interim solution to a limitation of the SLMAIL program.
  16. SLMAIL, when exporting messages from Searchlight's message base, will
  17. look for messages from SYSOP and create the resulting .MSG file with
  18. whatever name you specify in the SLMAIL.CFG file. Unfortunately, it ONLY
  19. looks for messages from SYSOP, not from anyone else.
  20.  
  21. Many Fidonet backbone conferences, including the SEARCHLIGHT conference,
  22. do not allow the use of handles or aliases. This creates a dilemma for
  23. Searchlight sysops in that no conference moderator has the right to tell
  24. any BBS operator that he can't allow his users to use a handle or alias
  25. on his BBS. So if you run a Searchlight BBS, carry the SEARCHLIGHT echomail
  26. conference or any other conference that prohibits the use of handles,
  27. and you let your users use handles on your BBS, you're basically faced with
  28. two choices. 1) You don't allow your users access to the conference, or
  29. 2) You let users with handles access the conference and risk having your
  30. link cut.
  31.  
  32. This program can give you some relief...
  33.  
  34. SLRENAME will scan .MSG files created by SLMAIL, look for a handle in
  35. the From: field of the message, and change the handle to the user's
  36. real name.
  37.  
  38. How to make it go:
  39.  
  40. Calling syntax:
  41.  
  42. SLRENAME  <drive:\messagepath\>
  43.  
  44. example:
  45.  
  46. SLRENAME C:\ECHOS\SEARCHLIGHT\
  47.  
  48. The program will scan C:\ECHOS\SEARCHLIGHT\ for messages to process.
  49.  
  50.  
  51. The config file
  52. ---------------
  53.  
  54. SLRENAME will read the configuration file SLMAIL.CFG for the names to
  55. convert. For example:
  56.  
  57. Bob Jones=MANIAC
  58. Steve Smith=BONEHEAD
  59.  
  60. If those two lines are in your configuration file, all the messages that
  61. have MANIAC in the From: field of the message, will have that handle replaced
  62. with Bob Jones. Likewise, messages from BONEHEAD will be replaced with Steve
  63. Smith. You can have up to 100 entries in the config file. Note that the equal
  64. sign is important, don't forget it. Also, the config file is CASE SENSITIVE.
  65.  
  66. Hints and stuff
  67. ---------------
  68.  
  69. Run SLRENAME immediately AFTER running SLMAIL in export mode. Run it
  70. BEFORE you use Confmail or Qmail or whatever to scan/export and pack
  71. up the messages. DON'T run the program before an SLMAIL IMPORT. Use it
  72. before you EXPORT with SLMAIL ONLY.
  73.  
  74.  
  75. Disclaimer
  76. ----------
  77.  
  78. This is a copyrighted work by Glen Johnson. You are free to use it,
  79. and distribute it provided that you make no changes to it, and provided
  80. that this documentation accompanies the software.
  81.  
  82. This program works just fine on my system, it may not on yours. Use of this
  83. program is ENTIRELY at your own risk. If you're not willing to accept
  84. full responsibility for what happens to your system as a direct or indirect
  85. result of using this program, DON'T use it. I assume no responsibility
  86. for its performance, fitness for a particular purpose, and assume no
  87. liability for damages, direct or indirect, incurred as a result of using
  88. or misusing this program. The software is provided free of charge, on an
  89. as-is basis.
  90.  
  91. Closing argument
  92. ----------------
  93.  
  94. When Frank LaRosa gets around to changing SLMAIL to convert ANY handle
  95. to a real name (not just SYSOP), this program will become instantly
  96. obsolete. So, I probably won't enhance it much.   Have fun.
  97.  
  98. Glen Johnson
  99. 1:269/101@fidonet
  100.